/*
 * Copyright (C) 2016 yixun All Rights Reserved.
 * 
 * ValidateCodeService.java
 */
package com.yixun.qfbao.service;

import com.yixun.common.page.Page;
import com.yixun.qfbao.model.ValidateCode;
import com.yixun.qfbao.model.dto.PartnerInfoDto;
import com.yixun.qfbao.model.dto.ValidateCodeDto;

import java.util.List;

/**
 * [文件名称]<br>
 * ValidateCodeService.java<br>
 * <br>
 * [文件描述]<br>
 * 手机验证码 service interface<br>
 * <br>
 * [修改记录]<br>
 * 2016-01-11 11:24:14 创建 陶俊代码生成器<br>
 * 
 * @author 陶俊代码生成器
 * @version 1.00
 */
public interface ValidateCodeService {
	/**
	 * @param entity 搜索条件
	 * @param begin 分页开始行数[不包含]
	 * @param end 分页结束行数[包含]
	 * @return 分页记录
	 */
	public Page<ValidateCode> getPageModel(ValidateCodeDto entity,int begin,int end);
	
	/**
	 * 查询列表
	 * @param entity 搜索条件
	 * @return 分页记录
	 */
	public List<ValidateCode> selectListByDto(ValidateCodeDto entity);
	
	/**
	 * 查询单个
	 * @param entity 搜索条件
	 * @return 分页记录
	 */
	public ValidateCode selectByDto(ValidateCodeDto entity);
	
	/**
	 * @param entity 根据主键搜索
	 * @return 一行记录
	 */
	public ValidateCode selectById(Long id);
	
	/**
	 * @param entity 根据pojo搜索如果主键为空则返回它本身
	 * @return 一行记录或本身
	 */
	public ValidateCode selectBy(ValidateCode entity);
	
	/**
	 * @param entity 新增记录的详细信息
	 * @return 新增行数
	 */
	public int create(ValidateCodeDto entity);
	/**
	 * @param entity 更新记录的详细信息
	 * @return 更新行数
	 */
	public int update(ValidateCodeDto entity);
	/**
	 * @param entity 待删除的记录信息
	 * @return 删除行数
	 */
	public int destroy(ValidateCodeDto entity);
	/**
	 * @param entity 新增或更新
	 * @return 新增行数
	 */
	public int saveOrUpdate(ValidateCodeDto entity);

	/**
	 * 验证码是否有效
	 * @param phone
	 * @param code
	 * @return
	 */
	boolean isValidate(String phone,String code);

	/**
	 * 将短信置为无效
	 * @param phone
	 */
	void deleteValidate(String phone);

	/**
	 * 充值密码发送验证码
	 * @author sangtao
	 * @param partnerInfo
	 * @return
	 */
	String sendValidateCodeForPwd(PartnerInfoDto partnerInfo,String companyUuid);
	
	/**
	 * 发送短信，并插入短信发送记录，以及验证码表
	 * @param phone 电话号码
	 * @param messageContent 内容，仅插入使用
	 * @param msgId 消息ID
	 * @param smsDesc 消息类型描述
	 * @param systemId 系统ID，仅入库使用
	 * @param companyUuid 公司UUID
	 * @param code 校验码
	 * @param companyId 公司ID
	 * @param msgs 短信替换模板中的参数值
	 * @return
	 */
	public boolean sendAndSaveSmsmsg(String phone, String messageContent, String msgId, String smsDesc,
			String systemId, String companyUuid,  String code, Long companyId, String...msgs);
}
